home *** CD-ROM | disk | FTP | other *** search
/ Celestin Apprentice 5 / Apprentice-Release5.iso / Environments / Prograph Classic 2.6.1 / Prograph Reference Manual / Prograph Reference 5-7 / Prograph Reference 5-7.rsrc / TEXT_135.txt < prev    next >
Encoding:
Text File  |  1995-10-25  |  6.1 KB  |  178 lines
  1. ¬†      Canvas 
  2.  
  3. Inherits from:     Window Item  
  4.  
  5.  
  6. _____________________________________________________
  7.  ¬†               name   *185*
  8.  
  9. Type:  string 
  10.  
  11. Description:    Used by the primitive find-item to find a ¬´Canvas¬ª by name. 
  12.  
  13.  
  14. _____________________________________________________
  15. ¬†                owner   *185*
  16.  
  17. Type:  Window 
  18.  
  19. Constraints:    Not settable.    
  20.  
  21. Description:  If ¬´Canvas¬ª is a member of item list of an active ¬´Window¬ª, then the value of this attribute is that ¬´Window¬ª. Otherwise the value of owner is NULL.    
  22.  
  23.  
  24. _____________________________________________________
  25. ¬†                active?   *185*
  26.  
  27.  
  28. Type:  boolean    
  29. Constraints:     Not settable on default. 
  30.  
  31. Description:     ¬´Canvas¬ª responds to clicks only if the value of this attribute is TRUE.    
  32. Side effects:  Setting causes ¬´Canvas¬ª to be redrawn. When the value of this attribute is set to FALSE, the vertical and horizontal scroll bars of ¬´Canvas¬ª are deactivated.
  33.     
  34.  
  35. _____________________________________________________
  36. ¬†                 visible?   *185*
  37.  
  38. Type:  boolean    
  39.  
  40. Description:  ¬´Canvas¬ª is displayed in the owning ¬´Window¬ª if and only if the value of this attribute is TRUE.    
  41.  
  42. Side effects:    Setting causes ¬´Canvas¬ª to be redrawn.     
  43.  
  44.  
  45. _____________________________________________________
  46. ¬†                 move?   *186*
  47.  
  48. Type:  boolean    
  49.  
  50. Description:     The location of ¬´Canvas¬ª is changed relative to the size of the owning ¬´Window¬ª if and only if the value of this attribute is TRUE.    
  51.  
  52.  
  53. _____________________________________________________
  54. ¬†                 grow?   *186*
  55.  
  56. Type:  boolean    
  57.  
  58. Description:     The size of ¬´Canvas¬ª is changed relative to the size of the owning ¬´Window¬ª if and only if the value of this attribute is TRUE.    
  59.  
  60.  
  61. _____________________________________________________
  62. ¬†                 location   *186*
  63.  
  64. Type:  Point    
  65.  
  66. Description:    Location of upper left corner of ¬´Canvas¬ª in owning ¬´Window¬ª.    
  67. Side effects:    Setting causes ¬´Canvas¬ª to be redrawn.    
  68.  
  69.  
  70.  
  71. _____________________________________________________
  72. ¬†                 size   *186*
  73.  
  74. Type:  Point    
  75.  
  76. Description:    Offset of lower right corner of ¬´Canvas¬ª from upper left corner.    
  77.  
  78. Side effects:    Setting causes ¬´Canvas¬ª to be redrawn.    
  79.  
  80.  
  81. _____________________________________________________
  82. ¬†                 balloon   *186*
  83.  
  84. Type:     list 
  85.  
  86. Description:    Balloon Help information; format varies with the type (Prograph string or 'STR ', 'STR#', 'TEXT' or 'PICT' resource) of Balloon Help.    
  87.  
  88.  
  89. _____________________________________________________
  90. ¬†                 border?   *187*
  91.  
  92. Type:     boolean 
  93.  
  94. Description:    A 1-point border is drawn around the ¬´Canvas¬ª if the value of this attribute is TRUE.    
  95.  
  96. Side effects:     Setting causes ¬´Canvas¬ª to be redrawn. 
  97.  
  98. ________________________________________
  99. ¬†                vControl   *187*
  100.  
  101. Type:  ControlRecord@@    
  102.  
  103. Constraints:    Not settable.    
  104.  
  105. Description:    Control record of the vertical scroll bar of ¬´Canvas¬ª.    
  106.  
  107.  
  108. _____________________________________________________
  109. ¬†                hControl   *187*
  110.  
  111. Type:  ControlRecord@@    
  112.  
  113. Constraints:    Not settable.    
  114.  
  115. Description:    Control record of the horizontal scroll bar of ¬´Canvas¬ª.    
  116.  
  117.  
  118. _____________________________________________________
  119. ¬†                vScroll?   *187*
  120.  
  121. Type:  boolean 
  122.  
  123. Constraints:    Not settable when owning ¬´Window¬ª is active. 
  124.  
  125. Description:     The item has a vertical scroll bar if and only if the value of this attribute is TRUE.    
  126.  
  127.  
  128. _____________________________________________________
  129. ¬†                hScroll?   *187*
  130.  
  131. Type:  boolean 
  132.  
  133. Constraints:    Not settable when owning ¬´Window¬ª is active. 
  134.  
  135. Description:     The item has a horizontal scroll bar if and only if the value of this attribute is TRUE.    
  136.  
  137.  
  138. _____________________________________________________
  139. ¬†                origin   *188*
  140.  
  141. Type:  Point    
  142.  
  143. Description:    The position on the drawing plane of the top left corner of the ¬´Canvas¬ª rectangle. The size of ¬´Canvas¬ª is defined by the value of its size attribute. The Canvas view is a view onto the drawing plane; the drawing plane can be much larger than this view. The size of the Canvas view depends on whether it has scroll bars or not. If it does, the Canvas view rectangle is the Canvas rectangle minus 15 pixels for the bottom coordinate if it has a horizontal scroll bar and minus 15 pixels for the right coordinate if it has a vertical scroll bar. The drawing plane defines the area into which one can draw; its bounding rectangle is specified by the value of the limits attribute. The drawing plane thus establishes the range over which the canvas view can be scrolled, and constrains the possible values of origin.    
  144.  
  145. Side effects:  Setting causes the Canvas view to be moved on the drawing plane and the scroll bars to be adjusted accordingly. 
  146.  
  147.  
  148. _____________________________________________________
  149. ¬†                limits   *188*
  150.  
  151. Type:     Rect    
  152.  
  153. Description:    The rectangle defining the size and coordinate system of the drawing plane (to which graphics instructions can be directed), and the area over which the Canvas view can range. The minimum and maximum values for each coordinate are -32K and +32K. If the limits rectangle is equal to or smaller than the Canvas view, and the origin is equal to the top-left corner of limits, then the scroll bars (if any) are inactive.    
  154.  
  155. Side effects:  Setting causes ¬´Canvas¬ª to be redrawn and the scroll bars to be adjusted appropriately.    
  156.  
  157.  
  158. _____________________________________________________
  159. ¬†                click method   *189*
  160.  
  161. Type:  string    
  162.  
  163. Description:     ¬´Canvas¬ª responds to clicks only if the value of this attribute is a nonempty string.    
  164.  
  165. Method inputs:    <owning ¬´Window¬ª>, ¬´Canvas¬ª, <Point of click>, <EventRecord of click>    
  166.  
  167.  
  168. _____________________________________________________
  169. ¬†                draw method  *189*
  170.  
  171. Type:  string    
  172.  
  173. Description: Name of the method called to redraw ¬´Canvas¬ª. If this method is called by the Application Manager in response to a redraw event, it is automatically framed between calls to sc-begin-drawing and sc-end-drawing. See Chapter 7, ‚ÄúThe Macintosh Toolbox‚Äù, for more details.    
  174.  
  175. Method inputs:     <owning ¬´Window¬ª>, ¬´Canvas¬ª, <EventRecord>    
  176.  
  177.  
  178.